home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / escrub.zip / EMERGE.DOC < prev    next >
Text File  |  1989-12-01  |  5KB  |  121 lines
  1.  
  2. EMERGE
  3. ------
  4. The purpose of the EMERGE program is to combine two files, in the echolist
  5. format, into 1 echolist.  The output echolist is composed of all entries
  6. found in either input file.  Duplicate entries are reconciled (found in
  7. both input files), so that only 1 entry is placed into the output file.
  8.  
  9. Here is the command line format:
  10.  
  11.     EMERGE   new_echolist   old_echolist   output
  12.  
  13. Where:
  14.  
  15.     new_echolist ..... The name of the new echolist file you have received
  16.                        that you wish to combine with the old echolist.  This
  17.                        could be the output of a prior run of EMERGE, if more
  18.                        than 1 merge operation needs to be done.
  19.  
  20.                        This file could also come from the IEC or other
  21.                        other echolist source, or it can be obtained from
  22.                        the ESCRUB program, described in ESCRUB.DOC.
  23.  
  24.                        However, it should be noted that the echolist
  25.                        provided by the IEC is NOT directly importable
  26.                        by EMERGE, as it most likely does not conform to
  27.                        the new format.  Therefore, manual alteration of
  28.                        that echolist may be required.  The echolist format
  29.                        used by EMERGE and ESCRUB is compatible with the log
  30.                        format produced by the ECOxxx.COM program, in use
  31.                        by local echo coordinators.
  32.  
  33.     old_echolist ..... The name of your old echolist file.
  34.  
  35.     output ........... The result of the reconciliation of the 'new_echolist'
  36.                        and the 'old_echolist'.  After a manual examination this
  37.                        file can be further processed or used as your working
  38.                        echolist.
  39.  
  40. Please note that all input files must be sorted prior to input to this
  41. program.  Otherwise, the merge will not match them up correctly.  Here is
  42. a sample batch file to run MERGE:
  43.  
  44.     sort <echolist.bbs >eco1
  45.     sort <c:\gt\echolist.bbs >eco2
  46.     emerge eco1 eco2 out
  47.     del eco1
  48.     del eco2
  49.  
  50. Where:
  51.  
  52.     sort ............. The DOS filter.  The program is supplied with DOS
  53.                        version 3.0+.  It is used here to insure that the
  54.                        input files are in conference number order.
  55.  
  56.     echolist.bbs ..... The output of a prior run of EMERGE or ESCRUB.  Or,
  57.                        with modification, an echolist provided by the IEC.
  58.  
  59.     eco1 ............. Temporary work files.  They are deleted when no longer
  60.     eco2               required.
  61.  
  62.     out .............. The final output file.  May be installed as your
  63.                        working echolist or chained into further runs of
  64.                        EMERGE, when more than 1 source of echolist is to be
  65.                        processed.
  66.  
  67. Echolist Format
  68. ---------------
  69. The following is a sample echolist:
  70.  
  71. E00/001  GT POWER Support                               009/000 01:00-06:00
  72. E01/007  The ECHOLIST                                   009/000 01:00-06:00
  73. E01/008  The NODELIST                                   009/000 01:00-06:00
  74.  
  75.            Column      Contents
  76.            ------      --------
  77.             1-3        Echo Series.  Ranges from E00-E99.
  78.                        Please note that with the advent of G bags and this
  79.                        new way of maintaining echolists, only E99 conferences
  80.                        will be considered 'local'.  This should be quite
  81.                        adequate for any net, 1,000 local conferences.
  82.  
  83.              4         '/'.  Constant.
  84.  
  85.             5-7        Conference number. Ranges from 000-999.
  86.  
  87.              8         Restriction code:
  88.  
  89.                             'p' .... Private conference.  Usually by
  90.                                      invitation only.
  91.                             'a' .... Adult material.  Do not expose to minors.
  92.                             'g' .... GT Sysops only.  Others not welcome.
  93.                             ' ' .... Blank - no restriction.
  94.  
  95.              9         Normally blank.  Will be set by EMERGE to '·' as a
  96.                        change marker.
  97.  
  98.             10-55      Conference description.
  99.  
  100.              56        Blank.  Constant.
  101.  
  102.             57-59      Net number of sponsor.  Must be in range 000-999.
  103.  
  104.              60        '/'.  Constant.
  105.  
  106.             61-63      Node number of sponsor.  Must be in range 000-999.
  107.  
  108.              64        Blank.  Constant.
  109.  
  110.             65-75      The time when the conference is available on the
  111.                        sponsors system.  The format is unrestricted, but is
  112.                        usually a range of hours in the Central Standard Time
  113.                        Zone of the U.S.A.
  114.  
  115.              76-?      Data following the time is not significant.  So comments
  116.                        might be added.
  117.  
  118. All files processed by ESCRUB and EMERGE must adhere to this format.  Otherwise
  119. the echolist will be malformed.
  120.  
  121.